package com.vegetable.modules.service.baseData;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.vegetable.common.utils.R;
import com.vegetable.modules.entity.baseData.ProductCategory;
import com.vegetable.modules.form.ProductCategoryForm;
import com.vegetable.modules.query.ProductCategoryQuery;
import com.vegetable.modules.vo.ProductCategoryTreeVO;
import com.vegetable.modules.vo.ProductCategoryVO;

import java.util.List;

/**
 * <p>
 * 商品分类服务接口
 * </p>
 *
 * @author wangruijie
 * @since 2024-12-10
 */
public interface IProductCategoryService extends IService<ProductCategory> {

    /**
     * 分页查询商品分类
     *
     * @param query 查询条件
     * @return 分页结果
     */
    IPage<ProductCategoryVO> getPageList(ProductCategoryQuery query);

    /**
     * 获取商品分类树
     *
     * @return 分类树
     */
    List<ProductCategoryTreeVO> getCategoryTree();

    /**
     * 根据父分类ID获取子分类
     *
     * @param parentId 父分类ID
     * @return 子分类列表
     */
    List<ProductCategory> getChildrenByParentId(Long parentId);

    /**
     * 新增商品分类
     *
     * @param form 分类表单
     * @return 操作结果
     */
    R addCategory(ProductCategoryForm form);

    /**
     * 更新商品分类
     *
     * @param form 分类表单
     * @return 操作结果
     */
    R updateCategory(ProductCategoryForm form);

    /**
     * 删除商品分类
     *
     * @param id 分类ID
     * @return 操作结果
     */
    R deleteCategory(Long id);

    /**
     * 启用/禁用分类
     *
     * @param id        分类ID
     * @param isEnabled 是否启用
     * @return 操作结果
     */
    R enableCategory(Long id, Integer isEnabled);

    /**
     * 获取分类详情
     *
     * @param id 分类ID
     * @return 分类详情
     */
    ProductCategoryVO getCategoryDetail(Long id);

    /**
     * 根据分类编码查询
     *
     * @param categoryCode 分类编码
     * @return 分类信息
     */
    ProductCategory getByCategoryCode(String categoryCode);

    /**
     * 验证分类编码是否唯一
     *
     * @param categoryCode 分类编码
     * @param excludeId    排除的ID（用于修改时验证）
     * @return 是否唯一
     */
    boolean isCategoryCodeUnique(String categoryCode, Long excludeId);

    /**
     * 获取所有顶级分类
     *
     * @return 顶级分类列表
     */
    List<ProductCategory> getTopCategories();

    /**
     * 根据分类名称模糊查询
     *
     * @param categoryName 分类名称
     * @return 分类列表
     */
    List<ProductCategory> searchByName(String categoryName);
}